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1.0  Scope 

Per  DI>MISC*8071 1,  Oils  manual  details  the  BDS-D  Combat  Vehicle  Command  and  Control 
(CVCC)  1.0.0  Cold  Start  Procedures.  Distribution  instructions,  interaction  with  other 
simulators,  and  hardware  compatibility  notes  (as  applicable),  build  instructions  as  well  as  a 
detailed  overview  of  the  software  release  are  included  in  the  ADST  Version  Description 
Document  for  the  CVCC;  document  number  ADST/WDL/TR“93-(X)3212, 


"I  Pete  Peterson  on  this  date  23  September,  1993,  hereby  certify  that  the  software  release 
BDS'D  CV(X  1.0.0  has  been  built  from  limited  access,  controlled  baseline.  This  software 
is,  to  the  best  of  my  knowledge,  free  of  malicious  code  intended  to  subvert  its  operation." 
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2.0  Cold  Start  Methodology 

The  Cold  Start  procedure  for  the  BDS-D  CVCC  1.0.0  describes  the  user’s  ability  to  load 
the  q>plication  software.  This  procedure  consists  of  installing  and  bringing  on-line  the 
^>^lkwons,  and  configuration  mes.  Verification  of  a  build  load  is  demonstrated  through  a 
senes  of  tests  or  a  checklist  This  procedure  also  provides  a  detailed  list  of  instructions  that 
allow  the  user  to  startup  and  shutdown  the  BDS-D  CVCC  1.0.0. 

2.1  Required  Resources 

The  following  sections  outline  the  requited  hardware  and  software  resources  needed  to 
install  and  bring  on-line  the  BDS-D  CVCC  1.0.0. 

2.1.1  Hardware  Resources 

The  BDS-D  CVCC  1.0.0  requires  the  following  hardware  configuration  resources  to  run; 
HardwaESlKm  Description 

Sun  SPARC  Sun  SPARC  workstation  configured  as  a  BnTOC.  This  workstation 

consists  of  a  Sun  SPARC  (1,  1+,  2,  IPC,  or  IPX)  with  48  MB  ram, 
405  MB  disk,  1  ethernet  card  and  1  (or  2  for  dud-headed  BnTOC) 
video  head(s)  including  GX  frame  buffer(s)  and  color  monitor(s). 

Sun  SPARC  Sun  SPARC  workstation  configured  as  an  IVIS.  This  workstation 

consists  of  a  Sun  SPARC  (1, 1+,  2,  EPC,  or  IPX)  with  48  MB  ram, 
405  MB  disk,  1  ethemet  card  and  1  video  head  including  GX  firame 
buffer(s)  and  CMI C6000  13”  color  monitor.  In  addition,  the  IVIS 
also  requites  1  Helographics  touch  screen,  2  RS-232  connector  and 
1  Analyx  1200  ADDA  card. 

150  MB  trqie  drive  A  150  MegaByte  tape  drive  must  be  installed  in  the  workstations  for 
application  installation. 


2.1.2  Software  Resources 

The  magnetic  media  (disks  and  tapes)  prepared  and  supplied  as  part  of  the  BDS-D  CVCC 
1.0.0  are  identified  below: 

Mcdial&pc  Lab^  Description 

DC  6150  Tape  CVCC  ai^lication  tape  C  V(X  aj^lication  tape 
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2.1.3  Other  Required  Resources 

The  BDS-D  CVCC  1.0.0  requires  the  following  additional  resources  to  run: 


Software  Item 
Operating  System 
X  software 


Description 

Sun  OS  4.1.1  with  loader  patches  or  Sun  OS  4.1.2. 

Open  Windows  3.0  and  ICS  Motif  1.1.3.  X,  Xt  and  Motif  sharable 
libraries  must  be  in  /usr/lib.  Motif  executables  must  be  in 
/usr/bin/Xll. 


Database  manager  GNU  gdbm  l.S.  GNU  gdbm  sharable  libraries  must  be  in  /usr/lib. 


2.2  Cold  Start  Procedures 

The  following  section  outlines  the  procedure  for  performing  a  cold-start  on  the  BDS-D 
CVCC  1.0.0  system. 

2.2.1  System  Requirements 

This  section  describes  the  system  on  which  the  BDS-D  CVCC  1.0.0  release  tape  will  be 
installed.  The  BDS-D  CVCC  1.0.0  release  is  to  be  installed  on  a  Sun  SPARC  workstation 
that  is  already  configured  to  run  the  previous  release  of  the  CVCC  software.  This 
configuration  is  described  in  paragraph  2.1. 

2.2.2  Installation  of  Release 

This  section  describes  the  installation  of  the  BDS-D  CVCC  1.0.0  release  tape  on  to  the  Sun 
SPARC  computer  systems.  The  installation  will  be  done  separately  for  the  Battalion 
Tactical  Citations  Ceatec  (BnTOC)  and  the  Inter- Vehicular  I^ormation  System  (IVIS) 
workstations.  The  installation  procedure  is  identical  for  both  the  BnTOC  and  IVIS 
workstations.  A  list  of  executable  ftles,  data  Hies,  conftguration  files,  startup  and 
shutdown  files  and  their  respective  location  in  the  directory  tree  is  shown  in  Tables  2-1, 
2-2, 2-3  and  2-4.  These  tables  allow  the  user  to  verify  that  all  the  files  are  copied  off  the 
BDS-D  CVCC  1.0.0  release  tape.  The  installer  must  add  links  as  necessary  so  that  the 
simnet  directory  is  accessible  from  the  root  directory.  The  installer  must  create  the 
directt>ry  /simnet^data/bntoc. 
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The  following  site  specific  files  must  be  preserved  and  restored  back  to  their  original  values 
at  the  end  of  Ae  installation.  The  files  on  the  installation  tape  are  examples  which  are  to  be 
used  to  set  up  new  sites.  The  template  for  the  /simnet/data/cvcc/bntoc_rt/config_sim.bntoc 
file  is  /simnet/data/cvcc/ccd_rt/config_sim.  Also,  the  correct  terrain  ^ta  base  needs  to  be 
installed  before  the  software  will  work. 

/simnet/data/cvcc/cvcc_rt/bsd.network.config 

/simnel/data/cvcc/cvcc_iVbsd.to.config 

/simnet^data/cvcc/cvcc_rt/network.coiifig 

/simnet/data/cvcc/cvcc_rt/to.config 

/simnet/data/cvcc/cvcc_rt/networ£config 

/simnet/data/cvcc/ccd_rt/config_std 

/simnet/data/cvcc/ccd_rt/config_sim 

/simnet/data/cvcc/bntoc_rt/config_sim.bntoc 

Once  the  software  has  been  installed,  then  the  following  must  be  added  to  the  user’s 
environment: 

Set  the  following  environment  variables: 

setenv  OPENWINHOME  /usr/openwin 

setenv  CVCC.HOME  /simnet/data/cvcc 

setenv  XAPPLRESDIR  /sininet/data/cvcc/cvcc_rt 

In  addition  the  environment  variable  SIMLE_DEVICE  must  point  to  the  correct  ethemet 
device,  the  man  path  must  include  /usr/local/man  and  $OPENWINHOME/man  and  the 
search  path  must  include  /usr/local/bin,  /usr/bin/Xll,  $OPENWINHOME/bin 
$OPENWTNHOME/bin/xview,  $OPENWINHOME/demo  and  /simnet/bin. 


INSTALLATION  PROCEDURE 


1.  Load  the  installation  tape  into  the  tape  drive. 

None 

2.  Log  on  to  the  Sun  SPARC  as  root. 

Tbe  console  terminal  will  diq)]ay  tbe  system 
prompt:  (i.e.  S1MLAB13  #) 

3.  Set  to  the  CQnect  destination  directory 
cd  /directory.namc 

Tbe  console  terminal  will  di^lay  tbe  system 
prooqM:  (i.e.  SIMLAB13  #) 

4.  Read  in  die  installation  tape.  Enter 
tar  zvf  /dcv/dcvice.name 

Tbe  t^  will  move,  filenames  will  scroll  by  on  the 
console  terminal. 

S.  When  the  tape  is  fully  rewound  and  the 
SIMLAB13  #  pronqx  appears,  remove  the 
installation  tape. 

None 
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Table  2-1:  Executable  software 


Hie  name 


simnet/binACVCXI!-LislBn 

simnet/bin/CVCX:-Sa»d 

simnei/bin/ammo 

simnet/bin/bntoc 

simnet/bin/cal-design 

simnet/bin/cal-touch 

simnet/bin/ccd 

simnet/bin/check 

simnet/bin/dimen 

simnet/bin^end 

simnet/bin/grab_console 

simnet/bin/ptrgen 

simnet/bin/shutdown 

simnet/bin/start-cal 

simnet/bin/stait-ccd 

simnet/bin/tocact 

simnet/bin/vap 


Description 


CVCC  {^plication  software 
CVCC  implication  software 
Test  software 
Logger  speciAc  fUtoing. 
(XD  calibration  software 
CCD  calibration  software 
CVCC  iq>plication  software 
Test  software 
Test  software 
Test  software 

CVCC  application  software 
Test  software 
Test  software 
CCD  calibration  software 
CVCC  application  software 
CVCC  application  software 
Test  software 


Table  2-2:  BnTOC  runtime  software 
File  name  E)escription 


simn^data/cvcc/bntoc_it/AnalAieaOpns 

simnet^data/cvcc/bntoc_r^Collection 

simna/data/cvcc/bntoc_it/EstSit 

simnet/data/cvcc/bntocjrtAntelEst 

simnetAlataA:vcc/lnitoc_iVC)ixiSit 

sironet^data/cvcc/bntocjrt/cmnsOrd 

sminet/data/cvoc/bntDC_ri/PerInlel 

simnetAIata/bvoc/bntocjt/PeiOpnl^ 

sinmBt/data/cvoc/bntocji/Roac^vt 

siinnet/data/cvccybntoc_ri/fmtmodule.uid 

sininetidatB/cvcc/bntoc_rt/fview.uid 

simnet/data/cvcc/bntDcjrt/nu^.uid 

simnet/data/cvoc/bntoc.rt/mviewer.uid 

simnet/data/cvcc/bntoc.rt/router.uid 

simnet/data/cvccybntoc_rt/tooemodule.uid 


BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
BnTOC  Form 
Form  description 
Form  description 
Form  description 
Form  description 
Form  description 
Form  description 
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Table  2-3:  CCD  run  time  software 


Hie  name 


Description 


simnet/data/cvcc/ccd_rt/action 

simnet/data/cvcc/ccd_rt/aggiegate 

sinine^data/cvcc/ccd_rt/color.full 

sinmet/data/cvcc/ccd_rt/color.mono 

siinnet/data/cvcc/ccd_jt/config_sim 

simnet/data/cvcc/ccd_it/config_std 

simnet/data/cvcc/ccd_rt/display 

simnet/data/cvcc/ccdjrt/tilelist 

sininet/data/cvcc/ccd_rtAnnotr 

sinuiet^data/cvcc/a;d_rt/m2^ 

simnet/data/cvcc/ccd_it/ma^.full 

simnet/data/cvcc/ccdjt/map.grid 

simnet/data/cvcc/ccd_rt/moide.base 

simnet/data/cvcc/ccd_rt/mode.devl 

simnet^data/cvcc/ccd_rt/mode.enhc 

simne^data/cvcc/ccd_rt/mode.expr 

simni^data/cvcc/ccd_rt/navigation 

simnet/data/cvcc/ccd_rt/ieceive 

simnet/data/cvcc/ccd_jrt/ieport 

siinnct/daia/cvcc/ccd_rt/rpt_new 

simnet/data/cvcc/ccd.it/ipt_show 

simnet/data/cvcc/ccd_rt/status 

sinuiet/data/cvcc/ccd^widget 


Resource  file 
Resource  file 
Resource  Hie 
Resource  tile 
Sample  simulator 
configuration  file 
Sample  standard  simulator 
contigtiration  file 
Resource  tile 
Resource  file 
Resource  file 
Resource  tile 
Resource  tile 
Resource  tile 
Resource  file 
Resource  tile 
Resource  tile 
Resource  tile 
Resource  tile 
Resource  file 
Resource  tile 
Resource  tile 
Resource  file 
Resource  file 
Resource  tile 


Table  2-4:  CVCC  run  time  software 


File  name  Description 


siinnetidata/cvcc/’cvcc_it/Bntoc  BnTOC  resource  tile 

sinuietAiata/cvoc/cvcc_rt/CXrD  CCD  resource  tile 

simnet/data/cvcc/cvcc_j1/Mwm  MMmi  application  resource  file 

sminet/data/cvcc/cvcc_.rt/Xd^aults  X  defaidts  resource  tile 

siinnet/data/cvcc/cvcc  rt/bsd.netwoik.contig  Sample  CVCC  contiguration 

file 

simnet^data/cvcc/cvcc_rt/bsd.to.contig  Sample  task  organization 

contiguration  fOe 

^net/data/cvcc/cvcc  rt/netwoik.contig  Sample  CVCC  configuration 

file 

simii^data/cvcG/cvccjVsimnetmac  Simnet  data  file 

simnet/data/cvcc/cvoc jVto.config  Sample  task  organization 

contiguration  tile 

simnet/data/cvcc/cvccjrtAitm.lisp  UTM  convosion  file 
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2.3  Warm  Start  and  Shutdown  Procedures 

The  following  section  outlines  the  procedure  for  performing  a  warm-start  and  shutdown  of 
the  BDS-DCVCC  1.0.0. 

2.3.1  Startup  Procedures 

This  section  describes  in  detail  how  to  startup  the  BDS-D  CVCC  1.0.0.  The  full  list  of 
command  line  switches  for  the  start-ccd,  ccd  and  bntoc  executables  are  given  in  Appendix 


STARTUP  PROCEDURES  for  the  BnTOC 


1.  Power  up  the  Sun  W(»lcstadoa. 

The  console  tominal  will  display:  login; 

2.  Log  in  as  cvcc 

The  console  terminal  will  display  a  system 
promptd.e.  SIMLAB13  #) 

3.  Kill  (^len  windows 

Enter,  kow 

The  console  terminal  will  display  a  system 
prmnpL(i.e.  S1MLAB13  #) 

4.  Start  opm  windows 

Enter  sow  for  a  single-headed  display 
or 

Enter  sow  -2  for  a  dual  headed  display. 

The  console  terminal  will  display  a  system 
I»ompL(i.e.  SIMLAB13  #) 

S:  Change  user  to  super  user 

Enter  SB 

The  terminal  will  display  a  super  user  iMtxnpL(i.e. 

*) 

6.  Clumgedifectixy  to  binary  executable  directory. 
Enter  cd  /simnet/bin 

The  terminal  will  display  a  supor  user  prompL(i.e. 

#) 

7.  Start  the  BnTOC  aiqrlication 

Enter  bntoc  -chptFiie  flie.name 
-other_switches 

See  Note. 

The  IVIS  will  display  the  initial  CVCC  di^lay 

Note:  See  Appendix  A  for  "bntoc"  options 
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STARTUP  PROCEDURES  for  the  IVIS 


C6nTr6l  Action 

EXPECTED  RESULTS 

1.  Power  up  tbe  Sun  Woricstation. 

The  console  tenninal  wiU  di^lay:  login: 

2.  Remote  log  in  as  cvcc 

The  terminal  will  display  a  system  promptQ.e. 
SIMLAB13#) 

3.  Kill  open  windows 

Enter  kow 

The  tenninal  will  display  a  system  prompt.(i.e. 
SIMLAB13#) 

4.  Start  open  windows 

Enter  sow  & 

The  terminal  will  display  a  system  prompt.(i.e. 
SIMLAB13#) 

S.  Change  user  to  super  user 

Enter  su 

The  terminal  will  display  a  super  user  ptDmpL(i.e. 

#) 

6.  Chmige  directory  to  binary  executable  directory. 
Enter  cd  /aimnct/bin 

The  terminal  will  display  a  super  user  piDmpL(i.e. 

#) 

7.  Start  the  IVIS  a(q)lication 

Enter  start*ccd  -map  •other_switches 

See  Note. 

The  IVIS  will  display  the  initial  CVCC  display 

Note:  See  Appendix  A  for  "start«ccd"  options 
2.3.2  Shutdown  Procedure 


The  following  written  set  of  procedures  describe  in  detail  how  to  shutdown  the  BDS-D 
CVCC  1.0.0.  This  procedure  is  the  same  for  the  BnTOC  and  the  IVIS  workstations. 


SHUTDOWN 

PROCEDURES 

fioNTftOL  ACTION 

EXPECTED  RESULTS 

1.  At  the  SIMLAB13  #  prompt,  enter  sync 

The  message:  syncing  disks...  will  appear,  then  the 

sync 

prompt  »>  will  be  displayed. 

fasthalt 

2.  Power  off  the  w(»icstation 

The  system  will  power  o^. 
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3.0  Release  Validations 

3.1  Cold  Start  Validation 

The  following  written  set  of  procedures  instructs  the  user  on  how  to  validate  the  success  of 
the  cold-start 

Cold-start  Validation  Instructions: 

The  expected  results  detailed  in  the  System  Preparation  and  Release  Installation  Procedure 
sections  are  indicative  of  a  successful  cold-start 

3.2  Warm  Start  Validation 

The  following  written  set  of  procedures  instructs  the  user  on  how  to  validate  the  load  once  it  is 
operational. 

Warm  Start  Validation  Instructions: 

The  expected  results  detailed  in  the  Startup  Procedure  section  are  indicative  of  a  successful  warm 
start. 
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start'Ccd,  ccd 

Usage:  ccd  [-options  ...]  (for  a  standalone  system) 

start-ccd  [-options  ...]  (for  a  system  in  a  simulator) 

GENERIC  CVCC  OPTIONS; 


-callSign  <callsign> 

Overrides  the  call  sign  speci^ed  in  the 
network  config  file. 

-chptFile  <filename> 

Use  specified  checkpoint  file  for  startup. 

-chptHome  <path> 

Use  this  directory  to  End  checkpoint  files. 

config  <tilename> 

Use  specified  file  for  the  network  config. 

-cpradius  <dist> 

Set  radius  for  selecting  cone  pts  to  disL 

-debug  <flags> 

Run  with  the  specified  debug  flags. 

-develop 

Run  in  development  mode. 

-dutyPosition  <dp> 

Overrides  the  duty  position  specified  in  the 
network.config  file. 

-exercise  <exerciseID> 

Exercise  ID  this  system  is  participating  in. 

-fresh: 

Use  the  a  fresh  state  as  the  startup  state. 

-nice  <num> 

Use  this  to  lower  the  process  priority.  (Don't 
use  it!) 

-nonnal 

Run  the  CCD/TVIS  in  experimental  mode. 

-processPriority  <nura> 

Use  this  to  increase  BnTOC  priority. 

-recover 

Use  the  last  run  state  as  the  startup  state. 

-root  <directory  path> 

Root  of  the  BnTOC  directory  system. 

-same 

Display  the  ccd  and  training  on  same  screen 

-swap 

Swap  the  ccd  and  training  screens. 

-tooeRle 

Use  specified  file  for  task  organization. 

-version 

Print  the  current  version  number  and  exit 

11 


ADST/WDl/rR-93-00321 1 


September  23, 1993 


CCD-SPECinC  OPTIONS: 
'attached 
-baseline 
-color 

-communication  <mode> 

-confine 

-driverport 

-enhanced 

-experimental 

-grid: 

-handle 

-innovate 

'isolate 

-loopback 

-ma^ 

-meraoiy 

-monochrome 

-mouse 

-notdb 

-standalone 


Operate  with  vehicle  simulator 

Operate  in  baseline  mode 

Present  a  full-color  display 

Use  specified  communication  mode 

Confine  pointer  to  CCD/IVIS 

Driver  Port  exists 

Operate  in  enhanced  baseline  mode 

Operate  in  experimental  mode 

No  map  features  in  the  map  display 

Pointing  device  is  comander's  handle 

Innovative  training  exercise 

Prevent  reception  from  Co  networks 

Loop  messages  back  to  IVIS 

Display  mt^  features  in  the  map  display 

Use  memory  allocator  to  find  memory  leaks. 

I^resent  a  monochrome  (amber)  display 

Pointing  device  is  mouse 

No  m^  features  in  the  map  display 

Operate  without  vehicle  simulator 

Pointing  deArice  is  touch  screen 


-touch 
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bntoc 

Usage:  bntoc  [-options 

GENERIC  CVCC  OPTIONS: 

-callSign  <caUsign> 

-chptl^e  <filename> 

-chptHome  <path> 

-config  <filenaine> 

-cpradius  <dist> 

-debug  <flags> 

-develop 

-dutyPosition  <dp> 

-exercise  <exerciseID> 

-fresh 

-nice  <num> 

-normal 

-[nxx%ssPriority  <num> 

-recover 

-root  <Kiirectory  path> 

-same 

-swap 

-tooeHle: 
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Overrides  the  call  sign  speciHed  in  the 
network  conHg  file. 

Use  specified  checkpoint  file  for  startup. 

Use  this  directory  to  find  checkpoint  files. 

Use  specified  file  for  the  network  config. 

Set  radius  for  selecting  cone  pts  to  dist 

Run  with  the  specified  debug  flags. 

Run  in  development  mode. 

Overrides  the  duty  position  specified  in  the 
network  config  file. 

Exercise  ID  this  system  is  participating  in. 

Use  the  a  fresh  state  as  the  startup  state. 

Use  this  to  lower  the  process  priority.  (Don't 
use  it!) 

Run  the  BnTOC  in  normal  mode. 

Use  this  to  increase  BnTOC  priority. 

Use  the  last  run  state  as  the  startup  state. 

Root  of  the  BnTOC  directory  system. 

Run  the  map  and  tools  on  the  same  screen. 
Swap  the  map  display  and  tools  screens. 

Use  specified  file  for  task  organization. 

Print  the  current  version  number  and  exit 


■versitm: 
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BnTOC  SPECIFIC  OPTIONS: 


-bridge  <hostname> 

Host  name  of  the  communications  bridge. 

-coordinator 

Use  this  W/S  as  the  checkpoint  coordinator. 

-memory: 

Use  memory  allocator  to  End  memory  leaks. 

-nobridge 

Send  messages  to  SELF  without  using 
bridge. 

-nofmt 

Run  without  the  format  module. 

-notooe 

Run  without  tte  TO/OE  module. 

-nomap 

Run  without  the  map  module. 

-nomsg 

Run  without  the  message  module. 

-notools 

Run  without  the  tools. 

-notdb 

Run  without  the  terrain. 
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